Aviation API

(0 reviews)

14 Freezing Level Charts

Freezing Level charts graphically show the freezing level for a specified area. At this time the only valid location is NZ.

This set of charts is returned as links to our asset store.

14.1 Latest for a Location

Request the latest set of freezing level charts issued for a location. A set of freezing level charts will contain charts from T+0 to T+48 at 3 hour intervals.

14.1.1 API Call:

GET /aviation/chart/freezinglevel/{region}/latest

14.1.2 Path Parameter:

Path Parameter	Example	Description
region	nz	A supported region. The region must be lowercase. This parameter is Mandatory.

14.1.3 Example:

This example would return the latest set of freezing level charts issued for New Zealand.

GET /aviation/chart/freezinglevel/nz/latest

14.1.4 API Response:

{
    "version": "1.0",
    "issue-time": "2025-09-08T22:47:01Z",
    "path": "/chart/freezinglevel/nz/latest",
    "response": [
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509081200_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "00",
            "met:valid-at": "2025-09-08T12:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509081500_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "03",
            "met:valid-at": "2025-09-08T15:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509081800_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "06",
            "met:valid-at": "2025-09-08T18:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509082100_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "09",
            "met:valid-at": "2025-09-08T21:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509090000_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "12",
            "met:valid-at": "2025-09-09T00:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509090300_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "15",
            "met:valid-at": "2025-09-09T03:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509090600_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "18",
            "met:valid-at": "2025-09-09T06:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509090900_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "21",
            "met:valid-at": "2025-09-09T09:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509091200_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "24",
            "met:valid-at": "2025-09-09T12:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509091500_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "27",
            "met:valid-at": "2025-09-09T15:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509091800_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "30",
            "met:valid-at": "2025-09-09T18:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509092100_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "33",
            "met:valid-at": "2025-09-09T21:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509100000_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "36",
            "met:valid-at": "2025-09-10T00:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509100300_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "39",
            "met:valid-at": "2025-09-10T03:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509100600_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "42",
            "met:valid-at": "2025-09-10T06:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509100900_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "45",
            "met:valid-at": "2025-09-10T09:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509101200_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "48",
            "met:valid-at": "2025-09-10T12:00:00Z",
            "met:region": "nz"
        }
    ]
}

14.2 Next n hours of charts for a location

Request the freezing level charts issued for a location that have a valid at time which is within the next n hours.

14.2.1 API Call:

GET /aviation/chart/freezinglevel/{region}/next/{n}/hours

14.2.2 Path Parameters:

Path Parameter	Example	Description
region	nz	A supported region. The region must be lowercase. This parameter is Mandatory.
n	48	The number of hours to get charts for. This parameter is Mandatory.

14.2.3 Example:

This example would return the set of freezing level charts for New Zealand that have a valid at time that is within ‘now-3 hours’ and ‘now + 4 hours’.

GET /aviation/chart/freezinglevel/nz/next/4/hours

14.2.4 API Response:

{
    "version": "1.0",
    "issue-time": "2025-09-08T22:52:53Z",
    "path": "/aviation/api/aviation/chart/freezinglevel/nz/next/4/hours",
    "response": [
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509082100_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "09",
            "met:valid-at": "2025-09-08T21:00:00Z",
            "met:region": "nz"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/freezinglevel/20250908/ecmwf_nz_202509081200_202509090000_202509081819.png",
            "met:analysis-time": "2025-09-08T12:00:00Z",
            "met:product-name": "freezinglevel",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T18:19:00Z",
            "met:model-name": "ecmwf",
            "met:prognosis-period": "12",
            "met:valid-at": "2025-09-09T00:00:00Z",
            "met:region": "nz"
        }
    ]
}